HealthQuantityType PRO

This document lists all supported HealthQuantityType identifiers, categorized by domain. Each type is associated with a measurable health-related metric and can be used to track fitness, vital signs, nutrition, environment, and more.


1. Body Measurements

IdentifierDescription
bodyMassWeight of the body (in kilograms or pounds)
bodyMassIndexBody Mass Index (BMI), a weight-to-height ratio
heightHeight of the user
bodyFatPercentagePercentage of fat in the body
leanBodyMassMass excluding fat, bones, and organs
waistCircumferenceWaist measurement, often used in metabolic health
appleSleepingWristTemperatureSkin temperature during sleep from Apple Watch
bodyTemperatureCore body temperature
basalBodyTemperatureMinimum daily body temperature, often used in fertility

2. Activity & Fitness

IdentifierDescription
stepCountNumber of steps taken
distanceWalkingRunningDistance walked or run
flightsClimbedNumber of floors climbed
activeEnergyBurnedActive calories burned through movement
basalEnergyBurnedCalories burned at rest
appleExerciseTimeTime spent in Apple-defined exercise
appleMoveTimeMove ring time for activity summary
appleStandTimeTime standing (Apple Watch)
pushCountNumber of wheelchair pushes
distanceWheelchairDistance traveled via wheelchair
nikeFuelDeprecated Nike activity score
estimatedWorkoutEffortScoreEffort score estimation (Apple Workout)
workoutEffortScoreDirect effort score from workouts
physicalEffortIntensity estimation of effort during workouts

3. Exercise-Specific Metrics

IdentifierDescription
cyclingSpeedSpeed during cycling
cyclingPowerPower output during cycling
cyclingCadencePedal revolutions per minute
cyclingFunctionalThresholdPowerMax sustainable power for cycling
distanceCyclingDistance cycled
distanceRowingDistance rowed
rowingSpeedSpeed while rowing
distanceSwimmingDistance swum
swimmingStrokeCountNumber of swimming strokes
distancePaddleSportsDistance paddled (e.g., kayaking)
paddleSportsSpeedSpeed during paddle sports
distanceSkatingSportsDistance in skating sports
distanceDownhillSnowSportsDistance in downhill skiing/snowboarding
distanceCrossCountrySkiingDistance in cross-country skiing
crossCountrySkiingSpeedSpeed in cross-country skiing

4. Running & Walking Analysis

IdentifierDescription
runningSpeedRunning speed
runningPowerRunning power output
runningStrideLengthStride length
runningVerticalOscillationVertical bounce during running
runningGroundContactTimeFoot-ground contact time
walkingStepLengthStep length while walking
walkingSpeedWalking speed
walkingAsymmetryPercentageGait asymmetry
walkingDoubleSupportPercentage% of time both feet are on ground
appleWalkingSteadinessApple’s fall risk metric
walkingHeartRateAverageAvg heart rate during walking
sixMinuteWalkTestDistanceDistance in 6-minute walk test
stairAscentSpeedSpeed ascending stairs
stairDescentSpeedSpeed descending stairs

5. Heart & Vitals

IdentifierDescription
heartRateBeats per minute
restingHeartRateResting heart rate
walkingHeartRateAverageAverage heart rate while walking
heartRateVariabilitySDNNHRV: Standard deviation of NN intervals
heartRateRecoveryOneMinuteHR recovery 1 min post-exercise
peripheralPerfusionIndexBlood perfusion index
atrialFibrillationBurdenAFib percentage over time
vo2MaxMax oxygen uptake, fitness metric
bloodPressureSystolicSystolic blood pressure
bloodPressureDiastolicDiastolic blood pressure
oxygenSaturationBlood oxygen %
bloodGlucoseBlood sugar level
insulinDeliveryInsulin delivered
inhalerUsageNumber of inhaler puffs
respiratoryRateBreaths per minute
forcedExpiratoryVolume1Volume in first second of exhalation
forcedVitalCapacityMax air exhaled after deep breath
peakExpiratoryFlowRatePeak flow during exhalation

6. Audio & Environment

IdentifierDescription
environmentalAudioExposureAmbient sound levels
environmentalSoundReductionNoise reduction via headphones
headphoneAudioExposureAudio exposure from headphones
uvExposureUltraviolet radiation exposure
timeInDaylightTime spent in daylight (Apple Watch)
underwaterDepthDepth below water during activity
waterTemperatureTemperature of water when swimming/diving

7. Nutrition (Dietary Intake)

IdentifierDescription
dietaryEnergyConsumedTotal dietary energy intake
dietaryProteinProtein intake
dietaryCarbohydratesCarbohydrate intake
dietaryFatTotalTotal fat intake
dietaryFatSaturatedSaturated fat
dietaryFatMonounsaturatedMonounsaturated fat
dietaryFatPolyunsaturatedPolyunsaturated fat
dietarySugarTotal sugar
dietaryFiberFiber
dietaryWaterWater intake (in mL or L)
dietaryCaffeineCaffeine intake
dietaryCholesterolCholesterol intake
dietarySodiumSodium intake
dietaryPotassiumPotassium intake
dietaryCalciumCalcium intake
dietaryIronIron intake
dietaryMagnesiumMagnesium intake
dietaryZincZinc intake
dietaryIodineIodine intake
dietaryVitaminAVitamin A intake
dietaryVitaminB6Vitamin B6 intake
dietaryVitaminB12Vitamin B12 intake
dietaryVitaminCVitamin C intake
dietaryVitaminDVitamin D intake
dietaryVitaminEVitamin E intake
dietaryVitaminKVitamin K intake
dietaryThiaminVitamin B1 intake
dietaryRiboflavinVitamin B2 intake
dietaryNiacinVitamin B3 intake
dietaryPantothenicAcidVitamin B5 intake
dietaryFolateFolate intake
dietaryCopperCopper intake
dietarySeleniumSelenium intake
dietaryChromiumChromium intake
dietaryManganeseManganese intake
dietaryMolybdenumMolybdenum intake
dietaryPhosphorusPhosphorus intake
dietaryBiotinBiotin intake

8. Lifestyle & Others

IdentifierDescription
bloodAlcoholContentBlood alcohol %
numberOfAlcoholicBeveragesCount of alcoholic drinks
numberOfTimesFallenFall detection count
appleSleepingBreathingDisturbancesSleep breathing irregularity count

When to Use HealthQuantityType

You will provide a HealthQuantityType string when:

  1. Querying quantity samples:
const results = await Health.queryQuantitySamples({
  type: "stepCount",
  startDate: new Date("2025-07-01"),
  endDate: new Date("2025-07-02")
})
  1. Writing a quantity sample:
const sample = HealthQuantitySample.create({
  type: "bodyMass",
  unit: HealthUnit.gramUnit(HealthUnitPrefix.kilo),
  value: 70.0,
  startDate: new Date("2025-07-01 00:00:00"),
  endDate:  new Date("2025-07-02 00:00:00"),
})

await Health.saveQuantitySample(sample)
  1. Reading statistics from a workout:
const stat = workout.allStatistics["heartRate"]
const avg = stat?.averageQuantity(HealthUnit.count().divided(HealthUnit.minute()))